home *** CD-ROM | disk | FTP | other *** search
Text File | 2002-10-03 | 120.6 KB | 1,783 lines
XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn - The RowColumn widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/RowColumn.h> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents Motif 2.1. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The RowColumn widget is a general purpose RowColumn manager capable of containing any widget type as a child. In general, it requires no special knowledge about how its children function and provides nothing beyond support for several different layout styles. However, it can be configured as a menu, in which case, it expects only certain children, and it configures to a particular layout. The menus supported are MenuBar, Pulldown or Popup menu panes, and OptionMenu. RowColumn uses the _X_m_Q_T_m_e_n_u_S_a_v_v_y trait and holds the _X_m_Q_T_m_e_n_u_S_y_s_t_e_m trait. The type of layout performed is controlled by how the application has set the various layout resources. It can be configured to lay out its children in either rows or columns. In addition, the application can specify how the children are laid out, as follows: +o The children are packed tightly together into either rows or columns +o Each child is placed in an identically sized box (producing a symmetrical look) +o A specific layout (the current _x and _y positions of the children control their location) In addition, the application has control over both the spacing that occurs between each row and column and the margin spacing present between the edges of the RowColumn widget and any children that are placed against it. The default XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn procedure for the RowColumn returns the value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx if one has been specified for the child. Otherwise, this procedure returns the number of children in the RowColumn's XXXXmmmmNNNNnnnnuuuummmmCCCChhhhiiiillllddddrrrreeeennnn list. In a MenuBar, Pulldown menu pane, or Popup menu pane the default for the XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss resource is 2. In an OptionMenu or a WorkArea, (such as a RadioBox or CheckBox) this resource is not applicable and its use is undefined. If an application wishes to place a 3-D shadow around an OptionMenu or WorkArea, it can create the RowColumn as a child of a Frame widget. Page 1 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) In a MenuBar, Pulldown menu pane, or Popup menu pane the XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee resource is not applicable and its use is undefined. In a WorkArea, the default for XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is XXXXmmmmTTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP. In an OptionMenu the default for XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is XXXXmmmmNNNNOOOONNNNEEEE. In a MenuBar, Pulldown menu pane, or Popup menu pane the XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn resource is not applicable and its use is undefined. In an OptionMenu or WorkArea, the default for XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn is True. If the parent of the RowColumn is a MenuShell, the XXXXmmmmNNNNmmmmaaaappppppppeeeeddddWWWWhhhheeeennnnMMMMaaaannnnaaaaggggeeeedddd resource is forced to False when the widget is realized. The user can specify resources in a resource file for the automatically created widgets and gadgets of an OptionMenu. The following list identifies the names of these widgets (or gadgets) and the associated OptionMenu areas. Option Menu Label Gadget OOOOppppttttiiiioooonnnnLLLLaaaabbbbeeeellll Option Menu Cascade Button OOOOppppttttiiiioooonnnnBBBBuuuuttttttttoooonnnn For the Popup and Pulldown Menupanes, popup and pulldown menus have particular behaviors when the <<<<BBBBttttnnnn1111>>>> button is pressed outside the menus. These behaviors are summarized here. When there is already a popped up menu, a user can either press <<<<BBBBttttnnnn1111>>>> in the same area as the popped up menu, or can press <<<<BBBBttttnnnn1111>>>> in another area that should have a menu popped up. When <<<<BBBBttttnnnn1111>>>> is pressed in the same area as the already popped up menu, that menu is unposted. If <<<<BBBBttttnnnn1111>>>> is pressed in a different area, the associated popup menu is posted for the new area. Note, however, that if the XXXXmmmmNNNNppppooooppppuuuuppppHHHHaaaannnnddddlllleeeerrrrCCCCaaaallllllllbbbbaaaacccckkkk of either XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr or XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee is available, then the callback may override these default behaviors. For pulldown menus, a user can press <<<<BBBBttttnnnn1111>>>> on the Cascade button to post the pulldown menu, then click on it again. Upon the second click, the pulldown menu is unposted. Popup menus are not allowed to have NULL parents. TTTTeeeeaaaarrrr----ooooffffffff MMMMeeeennnnuuuussss Pulldown and Popup menu panes support tear-off menus, which enable the user to retain a menu pane on the display to facilitate subsequent menu selections. A menu pane that can Page 2 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) be torn-off is identified by a tear-off button that spans the width of the menu pane and displays a dashed line. A torn-off menu pane contains a window manager system menu icon and a title bar. The window title displays the label of the cascade button that initiated the action when the label type is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG. If the label contains a pixmap the window title is empty. A tear-off menu from a Popup menu pane also displays an empty title. Tear-off menus should not be shared. The user can tear off a menu pane using the mouse or keyboard. Clicking <<<<BBBBttttnnnn1111>>>> or pressing <<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>> (or <<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>) on the tear-off button, tears off the menu pane at the current position. Pressing <<<<BBBBttttnnnn2222>>>> on the tear-off button tears off the menu pane and allows the user to drag the torn-off menu to a new position designated by releasing the mouse button. Tearing off a menu pane unposts the current active menu. Only one tear-off copy for each menu pane is allowed. Subsequent tear-off actions of a torn menu pane unpost the existing copy first. The name of the tear-off button of a torn-off menu pane is TTTTeeeeaaaarrrrOOOOffffffffCCCCoooonnnnttttrrrroooollll. The name can be used to set resources in a resource file. An application can also obtain the tear-off button itself using XXXXmmmmGGGGeeeettttTTTTeeeeaaaarrrrOOOOffffffffCCCCoooonnnnttttrrrroooollll and then set resource values by calling XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss. The tear-off button has Separator-like behavior. Its appearance can be specified with the following tear-off button resources: XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd, XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnnddddPPPPiiiixxxxmmmmaaaapppp, XXXXmmmmNNNNbbbboooottttttttoooommmmSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr, XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd, XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnn, XXXXmmmmNNNNsssseeeeppppaaaarrrraaaattttoooorrrrTTTTyyyyppppeeee, XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss, and XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr. Refer to the XXXXmmmmSSSSeeeeppppaaaarrrraaaattttoooorrrr reference page for a complete description of each of these resources. The XXXXmmmmNNNNtttteeeeaaaarrrrOOOOffffffffMMMMooooddddeeeellll, XXXXmmmmNNNNtttteeeeaaaarrrrOOOOffffffffMMMMeeeennnnuuuuAAAAccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk, and XXXXmmmmNNNNtttteeeeaaaarrrrOOOOffffffffMMMMeeeennnnuuuuDDDDeeeeaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkkare RowColumn resources that affect tear-off menu behavior. The XXXXmmmmNNNNtttteeeeaaaarrrrOOOOffffffffTTTTiiiittttlllleeee resource enables the application to specify the tear-off menu's title if the menu is torn off. By default, menus do not tear off. Setting the XXXXmmmmNNNNtttteeeeaaaarrrrOOOOffffffffMMMMooooddddeeeellll resource to XXXXmmmmTTTTEEEEAAAARRRR____OOOOFFFFFFFF____EEEENNNNAAAABBBBLLLLEEEEDDDDenables tear- off functionality. There is no resource converter preregistered for XXXXmmmmNNNNtttteeeeaaaarrrrOOOOffffffffMMMMooooddddeeeellll. To allow tear-off functionality to be enabled through the resource database, call the function XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeIIIInnnnssssttttaaaallllllllTTTTeeeeaaaarrrrOOOOffffffffMMMMooooddddeeeellllCCCCoooonnnnvvvveeeerrrrtttteeeerrrr. Tear-off menu focus policy follows standard window manager policy. It is recommended that the ssssttttaaaarrrrttttuuuuppppKKKKeeeeyyyyFFFFooooccccuuuussss and aaaauuuuttttooooKKKKeeeeyyyyFFFFooooccccuuuussssmmmmwwwwmmmm resources be set to True. Page 3 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) DDDDeeeesssscccceeeennnnddddaaaannnnttttssss RowColumn automatically creates the descendants shown in the following table. An application can use XXXXttttNNNNaaaammmmeeeeTTTTooooWWWWiiiiddddggggeeeetttt to gain access to the named descendant. In addition, a user or an application can use the named descendant when specifying resource values. NNNNaaaammmmeeeedddd DDDDeeeesssscccceeeennnnddddaaaannnntttt CCCCllllaaaassssssss IIIIddddeeeennnnttttiiiittttyyyy ______________________________________________________________________________________________________________________________ OOOOppppttttiiiioooonnnnBBBBuuuuttttttttoooonnnn XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt option menu button OOOOppppttttiiiioooonnnnLLLLaaaabbbbeeeellll XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt option menu label TTTTeeeeaaaarrrrOOOOffffffffCCCCoooonnnnttttrrrroooollll subclass of XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee tear-off button of torn-off menu pane CCCCllllaaaasssssssseeeessss RowColumn inherits behavior, resources, and traits from CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr classes. The class pointer is _x_m_R_o_w_C_o_l_u_m_n_W_i_d_g_e_t_C_l_a_s_s. The class name is XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is not applicable (N/A). XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNadjustLast XmCAdjustLast Boolean True CSG XmNadjustMargin XmCAdjustMargin Boolean True CSG XmNentryAlignment XmCAlignment unsigned char XmALIGNMENT_BEGINNING CSG XmNentryBorder XmCEntryBorder Dimension 0 CSG XmNentryCallback XmCCallback XtCallbackList NULL C XmNentryClass XmCEntryClass WidgetClass dynamic CSG XmNentryVerticalAlignment XmCVerticalAlignment unsigned char XmALIGNMENT_CENTER CSG XmNisAligned XmCIsAligned Boolean True CSG XmNisHomogeneous XmCIsHomogeneous Boolean dynamic CG XmNlabelString XmCXmString XmString NULL C XmNmapCallback XmCCallback XtCallbackList NULL C XmNmarginHeight XmCMarginHeight Dimension dynamic CSG Page 4 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) XmNmarginWidth XmCMarginWidth Dimension dynamic CSG XmNmenuAccelerator XmCAccelerators String dynamic CSG XmNmenuHelpWidget XmCMenuWidget Widget NULL CSG XmNmenuHistory XmCMenuWidget Widget NULL CSG XmNmenuPost XmCMenuPost String NULL CSG XmNmnemonic XmCMnemonic KeySym NULL CSG XmNmnemonicCharSet XmCMnemonicCharSet String XmFONTLIST_DEFAULT_TAG CSG XmNnumColumns XmCNumColumns short 1 CSG XmNorientation XmCOrientation unsigned char dynamic CSG XmNpacking XmCPacking unsigned char dynamic CSG XmNpopupEnabled XmCPopupEnabled int XmPOPUP_KEYBOARD CSG XmNradioAlwaysOne XmCRadioAlwaysOne Boolean True CSG XmNradioBehavior XmCRadioBehavior Boolean False CSG XmNresizeHeight XmCResizeHeight Boolean True CSG XmNresizeWidth XmCResizeWidth Boolean True CSG XmNrowColumnType XmCRowColumnType unsigned char XmWORK_AREA CG XmNspacing XmCSpacing Dimension dynamic CSG XmNsubMenuId XmCMenuWidget Widget NULL CSG XmNtearOffMenuActivateCallback XmCCallback XtCallbackList NULL C XmNtearOffMenuDeactivateCallback XmCCallback XtCallbackList NULL C XmNtearOffModel XmCTearOffModel unsigned char XmTEAR_OFF_DISABLED CSG XmNtearOffTitle XmCTearOffTitle XmString NULL CSG XmNunmapCallback XmCCallback XtCallbackList NULL C XmNwhichButton XmCWhichButton unsigned int dynamic CSG XXXXmmmmNNNNaaaaddddjjjjuuuussssttttLLLLaaaasssstttt Extends the last row of children to the bottom edge of RowColumn (when XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn is XXXXmmmmHHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL) or extends the last column to the right edge of RowColumn (when XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn is XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL). Setting XXXXmmmmNNNNaaaaddddjjjjuuuussssttttLLLLaaaasssstttt to False disables this feature. XXXXmmmmNNNNaaaaddddjjjjuuuussssttttMMMMaaaarrrrggggiiiinnnn Specifies whether the inner minor margins of all items contained within the RowColumn widget are forced to the same value. The inner minor margin corresponds to the XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnLLLLeeeefffftttt, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnRRRRiiiigggghhhhtttt, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnTTTToooopppp, and XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnBBBBoooottttttttoooommmm resources supported by XXXXmmmmLLLLaaaabbbbeeeellll and XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt. A horizontal orientation causes XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnTTTToooopppp and XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnBBBBoooottttttttoooommmm for all items in a particular row to be forced to the same value; the value is the largest margin specified for one of the Label items. A vertical orientation causes XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnLLLLeeeefffftttt and XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnRRRRiiiigggghhhhtttt for all items in a particular column to be forced to the same value; the value is the largest margin specified for one of the Label items. Page 5 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) This keeps all text within each row or column lined up with all other text in its row or column. If XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is either XXXXmmmmMMMMEEEENNNNUUUU____PPPPOOOOPPPPUUUUPPPP or XXXXmmmmMMMMEEEENNNNUUUU____PPPPUUUULLLLLLLLDDDDOOOOWWWWNNNN and this resource is True, only button children have their margins adjusted. XXXXmmmmNNNNeeeennnnttttrrrryyyyAAAAlllliiiiggggnnnnmmmmeeeennnntttt Specifies the alignment type for children that are subclasses of XXXXmmmmLLLLaaaabbbbeeeellll or XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt when XXXXmmmmNNNNiiiissssAAAAlllliiiiggggnnnneeeedddd is enabled. The following are textual alignment types: +o XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG (default) +o XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCEEEENNNNTTTTEEEERRRR +o XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____EEEENNNNDDDD See the description of XXXXmmmmNNNNaaaalllliiiiggggnnnnmmmmeeeennnntttt in the XXXXmmmmLLLLaaaabbbbeeeellll(3) reference page for an explanation of these actions. XXXXmmmmNNNNeeeennnnttttrrrryyyyBBBBoooorrrrddddeeeerrrr Imposes a uniform border width upon all RowColumn's children. The default value is 0 (zero), which disables the feature. XXXXmmmmNNNNeeeennnnttttrrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk Disables the XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk and XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkcallbacks for all CascadeButton, DrawnButton, PushButton, and ToggleButton widgets and gadgets contained within the RowColumn widget. If the application supplies this resource, the XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkkand XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks are then revectored to the XXXXmmmmNNNNeeeennnnttttrrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk callbacks. This allows an application to supply a single callback routine for handling all items contained in a RowColumn widget. The callback reason is XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE. If the application does not supply this resource, the XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk and XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkcallbacks for each item in the RowColumn widget work as normal. The application must supply this resource when this widget is created. Changing this resource using the XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss is not supported. XXXXmmmmNNNNeeeennnnttttrrrryyyyCCCCllllaaaassssssss Specifies the only widget class that can be added to the RowColumn widget; this resource is meaningful only when the XXXXmmmmNNNNiiiissssHHHHoooommmmooooggggeeeennnneeeeoooouuuussss resource Page 6 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) is set to True. Both widget and gadget variants of the specified class may be added to the widget. When XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRaaaaddddiiiiooooBBBBooooxxxx is called or when XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA and XXXXmmmmNNNNrrrraaaaddddiiiiooooBBBBeeeehhhhaaaavvvviiiioooorrrr is True, the default value of XXXXmmmmNNNNeeeennnnttttrrrryyyyCCCCllllaaaassssssss is _x_m_T_o_g_g_l_e_B_u_t_t_o_n_G_a_d_g_e_t_C_l_a_s_s. When XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmMMMMEEEENNNNUUUU____BBBBAAAARRRR, the value of XXXXmmmmNNNNeeeennnnttttrrrryyyyCCCCllllaaaassssssss is forced to _x_m_C_a_s_c_a_d_e_B_u_t_t_o_n_W_i_d_g_e_t_C_l_a_s_s. XXXXmmmmNNNNeeeennnnttttrrrryyyyVVVVeeeerrrrttttiiiiccccaaaallllAAAAlllliiiiggggnnnnmmmmeeeennnntttt Specifies the type of vertical alignment for children that are subclasses of XXXXmmmmLLLLaaaabbbbeeeellll, XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt,,,, aaaannnndddd XXXXmmmmTTTTeeeexxxxtttt. This resource is invalid if XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn is XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLLand XXXXmmmmNNNNppppaaaacccckkkkiiiinnnngggg is XXXXmmmmPPPPAAAACCCCKKKK____TTTTIIIIGGGGHHHHTTTT, because this layout preserves variable heights among the children. The vertical alignment types include: XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____BBBBAAAASSSSEEEELLLLIIIINNNNEEEE____BBBBOOOOTTTTTTTTOOOOMMMM Causes the bottom baseline of all children in a row to be aligned. This resource is applicable only when all children in a row contain textual data. XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____BBBBAAAASSSSEEEELLLLIIIINNNNEEEE____TTTTOOOOPPPP Causes the top baseline of all children in a row to be aligned. This resource is applicable only when all children in a row contain textual data. XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCOOOONNNNTTTTEEEENNNNTTTTSSSS____BBBBOOOOTTTTTTTTOOOOMMMM Causes the bottom of the contents (text or pixmap) of all children in a row to be aligned. XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCEEEENNNNTTTTEEEERRRR Causes the center of all children in a row to be aligned. XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCOOOONNNNTTTTEEEENNNNTTTTSSSS____TTTTOOOOPPPP Causes the top of the contents (text or pixmap) of all children in a row to be aligned. XXXXmmmmNNNNiiiissssAAAAlllliiiiggggnnnneeeedddd Specifies text alignment for each item within the RowColumn widget; this applies only to items that are subclasses of XXXXmmmmLLLLaaaabbbbeeeellll or XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt. However, if the item is a Label widget or gadget and its parent is either a Popup menu pane or a Page 7 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) Pulldown menu pane, alignment is not performed; the Label is treated as the title within the menu pane, and the alignment set by the application is not overridden. XXXXmmmmNNNNeeeennnnttttrrrryyyyAAAAlllliiiiggggnnnnmmmmeeeennnntttt controls the type of textual alignment. XXXXmmmmNNNNiiiissssHHHHoooommmmooooggggeeeennnneeeeoooouuuussss Indicates whether the RowColumn widget should enforce exact homogeneity among the items it contains; if this resource is set to True, only the widgets that are of the class indicated by XXXXmmmmNNNNeeeennnnttttrrrryyyyCCCCllllaaaassssssssare allowed as children of the RowColumn widget. This is most often used when creating a MenuBar. Attempting to insert a child that is not a member of the specified class generates a warning message. In a MenuBar, the value of XXXXmmmmNNNNiiiissssHHHHoooommmmooooggggeeeennnneeeeoooouuuussss is forced to True. In an OptionMenu, the value is forced to False. When XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRaaaaddddiiiiooooBBBBooooxxxx is called the default value is True. Otherwise, the default value is False. XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg When XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN, this resource points to a text string that displays the label with respect to the selection area. The positioning of the label relative to the selection area depends on the layout direction in the horizontal orientation. This resource is not meaningful for all other RowColumn types. If the application wishes to change the label after creation, it must get the LabelGadget ID (XXXXmmmmOOOOppppttttiiiioooonnnnLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt) and call XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss on the LabelGadget directly. The default value is no label. XXXXmmmmNNNNmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk Specifies a widget-specific callback function that is invoked when the window associated with the RowColumn widget is about to be mapped. The callback reason is XXXXmmmmCCCCRRRR____MMMMAAAAPPPP. XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt Specifies the amount of blank space between the top edge of the RowColumn widget and the first item in each column, and the bottom edge of the RowColumn widget and the last item in each column. The default value is 0 (zero) for Pulldown and Popup menu panes, and 3 pixels for other RowColumn types. Page 8 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh Specifies the amount of blank space between the left edge of the RowColumn widget and the first item in each row, and the right edge of the RowColumn widget and the last item in each row. The default value is 0 (zero) for Pulldown and Popup menu panes, and 3 pixels for other RowColumn types. XXXXmmmmNNNNmmmmeeeennnnuuuuAAAAcccccccceeeelllleeeerrrraaaattttoooorrrr This resource is useful only when the RowColumn widget has been configured to operate as a Popup menu pane or a MenuBar. The format of this resource is similar to the left side specification of a translation string, with the limitation that it must specify a key event. For a Popup menu pane, when the accelerator is typed by the user, the Popup menu pane is posted. For a MenuBar, when the accelerator is typed by the user, the first item in the MenuBar is highlighted, and traversal is enabled in the MenuBar. The default for a Popup menu pane is <<<<oooossssffffMMMMeeeennnnuuuu>>>>. The default for a MenuBar is <<<<oooossssffffMMMMeeeennnnuuuuBBBBaaaarrrr>>>>. Setting the XXXXmmmmNNNNppppooooppppuuuuppppEEEEnnnnaaaabbbblllleeeedddd resource to False disables the accelerator. XXXXmmmmNNNNmmmmeeeennnnuuuuHHHHeeeellllppppWWWWiiiiddddggggeeeetttt Specifies the widget ID for the CascadeButton, which is treated as the Help widget if XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmMMMMEEEENNNNUUUU____BBBBAAAARRRR. Which corner of the MenuBar the Help widget is placed at depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource of the widget. If the RowColumn widget is any type other than XXXXmmmmMMMMEEEENNNNUUUU____BBBBAAAARRRR, this resource is not meaningful. XXXXmmmmNNNNmmmmeeeennnnuuuuHHHHiiiissssttttoooorrrryyyy Specifies the widget ID of the last menu entry to be activated. It is also useful for specifying the current selection for an OptionMenu. If XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN, the specified menu item is positioned under the cursor when the menu is displayed. If the RowColumn widget has the XXXXmmmmNNNNrrrraaaaddddiiiiooooBBBBeeeehhhhaaaavvvviiiioooorrrr resource set to True, the widget field associated with this resource contains the widget ID of the last ToggleButton or ToggleButtonGadget to change from unselected to selected. The default value is the widget ID of the first child in the widget. XXXXmmmmNNNNmmmmeeeennnnuuuuPPPPoooosssstttt Specifies an X event description indicating a Page 9 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) button event that posts a menu system. The default for XXXXmmmmMMMMEEEENNNNUUUU____PPPPOOOOPPPPUUUUPPPP is BBBBMMMMeeeennnnuuuu PPPPrrrreeeessssssss. The default for XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN, XXXXmmmmMMMMEEEENNNNUUUU____BBBBAAAARRRR, and XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA is <<<<BBBBttttnnnn1111>>>> PPPPrrrreeeessssssss. The XXXXmmmmNNNNmmmmeeeennnnuuuuPPPPoooosssstttt resource for pulldowns should be consistent with that of the top-level parent menu (although the event type is ignored). Setting this resource to BBBBTTTTrrrraaaannnnssssffffeeeerrrr PPPPrrrreeeessssssss will conflict with drag and drop operations, which use BBBBTTTTrrrraaaannnnssssffffeeeerrrr PPPPrrrreeeessssssss as a default button binding. Therefore, this resource cannot be BBBBTTTTrrrraaaannnnssssffffeeeerrrr PPPPrrrreeeessssssss. XXXXmmmmNNNNmmmmnnnneeeemmmmoooonnnniiiicccc This resource is useful only when XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN. It specifies a keysym for a key that, when pressed by the user along with the MMMMAAAAlllltttt modifier, posts the associated Pulldown menu pane. The first character in the OptionMenu label string that exactly matches the mnemonic in the character set specified in XXXXmmmmNNNNmmmmnnnneeeemmmmoooonnnniiiiccccCCCChhhhaaaarrrrSSSSeeeettttis underlined. The user can post the menu by pressing either the shifted or the unshifted mnemonic key. The default is no mnemonic. XXXXmmmmNNNNmmmmnnnneeeemmmmoooonnnniiiiccccCCCChhhhaaaarrrrSSSSeeeetttt Specifies the character set of the mnemonic for an OptionMenu. The default is XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG. If the RowColumn widget is any type other than XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN, this resource is not meaningful. XXXXmmmmNNNNnnnnuuuummmmCCCCoooolllluuuummmmnnnnssss Specifies the number of minor dimension extensions that are made to accommodate the entries; this attribute is meaningful only when XXXXmmmmNNNNppppaaaacccckkkkiiiinnnngggg is set to XXXXmmmmPPPPAAAACCCCKKKK____CCCCOOOOLLLLUUUUMMMMNNNN. For vertically oriented RowColumn widgets, this attribute indicates how many columns are built; the number of entries per column is adjusted to maintain this number of columns, if possible. For horizontally oriented RowColumn widgets, this attribute indicates how many rows are built. The default value is 1. In an OptionMenu the value is forced to 1. The value must be greater than 0 (zero). XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn Determines whether RowColumn layouts are row-major Page 10 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) or column-major. In a column-major layout, the children of the RowColumn are laid out in columns within the widget. In a row-major layout the children of the RowColumn are laid out in rows. The direction of the horizontal layout in the row-major layout (from left or right), and the wrapping in the column-major layout (vertical), depend on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource of the widget. The XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL resource value selects a column-major layout. XXXXmmmmHHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL selects a row- major layout. When creating a MenuBar or an OptionMenu, the default is XXXXmmmmHHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL. Otherwise, the default value is XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL. The results of specifying a value of XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL for a MenuBar are undefined. XXXXmmmmNNNNppppaaaacccckkkkiiiinnnngggg Specifies how to pack the items contained within a RowColumn widget. This can be set to XXXXmmmmPPPPAAAACCCCKKKK____TTTTIIIIGGGGHHHHTTTT,,,, XXXXmmmmPPPPAAAACCCCKKKK____CCCCOOOOLLLLUUUUMMMMNNNN or XXXXmmmmPPPPAAAACCCCKKKK____NNNNOOOONNNNEEEE. When a RowColumn widget packs the items it contains, it determines its major dimension using the value of the XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn resource. XXXXmmmmPPPPAAAACCCCKKKK____TTTTIIIIGGGGHHHHTTTT indicates that given the current major dimension (for example, vertical if XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn is XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL), entries are placed one after the other until the RowColumn widget must wrap. RowColumn wraps when there is no room left for a complete child in that dimension. Wrapping occurs by beginning a new row or column in the next available space. Wrapping continues, as often as necessary, until all of the children are laid out. In the vertical dimension (columns), boxes are set to the same width; in the horizontal dimension (rows), boxes are set to the same depth. Each entry's position in the major dimension is left unaltered (for example, XXXXmmmmNNNNyyyy is left unchanged when XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn is XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL); its position in the minor dimension is set to the same value as the greatest entry in that particular row or column. The position in the minor dimension of any particular row or column is independent of all other rows or columns. XXXXmmmmPPPPAAAACCCCKKKK____CCCCOOOOLLLLUUUUMMMMNNNN indicates that all entries are placed in identically sized boxes. The boxes are based on the largest height and width values of all the children widgets. The value of the XXXXmmmmNNNNnnnnuuuummmmCCCCoooolllluuuummmmnnnnssssresource determines how many boxes are placed in the major dimension, before Page 11 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) extending in the minor dimension. XXXXmmmmPPPPAAAACCCCKKKK____NNNNOOOONNNNEEEE indicates that no packing is performed. The _x and _y attributes of each entry are left alone, and the RowColumn widget attempts to become large enough to enclose all entries. When XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRaaaaddddiiiiooooBBBBooooxxxx is called or when XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeeeis set to XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA and XXXXmmmmNNNNrrrraaaaddddiiiiooooBBBBeeeehhhhaaaavvvviiiioooorrrr is True, the default value of XXXXmmmmNNNNppppaaaacccckkkkiiiinnnngggg is XXXXmmmmPPPPAAAACCCCKKKK____CCCCOOOOLLLLUUUUMMMMNNNN. In an OptionMenu the value is initialized to XXXXmmmmPPPPAAAACCCCKKKK____TTTTIIIIGGGGHHHHTTTT. Otherwise, the value defaults to XXXXmmmmPPPPAAAACCCCKKKK____TTTTIIIIGGGGHHHHTTTT. XXXXmmmmNNNNppppooooppppuuuuppppEEEEnnnnaaaabbbblllleeeedddd Allows the menu system to enable keyboard input (accelerators and mnemonics) defined for the Popup menu pane and any of its submenus. The Popup menu pane needs to be informed whenever its accessibility to the user changes because posting of the Popup menu pane is controlled by the application. This resource can take four values, including: XXXXmmmmPPPPOOOOPPPPUUUUPPPP____KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD Specifies that the keyboard input- accelerators and mnemonics-defined for the Popup menu pane and any of its submenus is enabled. This is the default. XXXXmmmmPPPPOOOOPPPPUUUUPPPP____DDDDIIIISSSSAAAABBBBLLLLEEEEDDDD Specifies that the keyboard input is disabled. XXXXmmmmPPPPOOOOPPPPUUUUPPPP____AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC Specifies that the keyboard is enabled for automatic popup menus. XXXXmmmmPPPPOOOOPPPPUUUUPPPP____AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC____RRRREEEECCCCUUUURRRRSSSSIIIIVVVVEEEE Specifies that the keyboard is enabled for recursive automatic popup menus. XXXXmmmmNNNNrrrraaaaddddiiiiooooAAAAllllwwwwaaaayyyyssssOOOOnnnneeee If True, forces the active ToggleButton or ToggleButtonGadget to be automatically selected after having been unselected (if no other toggle was activated). If False, the active toggle may be unselected. The default value is True. This resource is important only when XXXXmmmmNNNNrrrraaaaddddiiiiooooBBBBeeeehhhhaaaavvvviiiioooorrrr is True. Page 12 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) The application can always add and subtract toggles from RowColumn regardless of the selected/unselected state of the toggle. The application can also manage and unmanage toggle children of RowColumn at any time regardless of state. Therefore, the application can sometimes create a RowColumn that has XXXXmmmmNNNNrrrraaaaddddiiiiooooAAAAllllwwwwaaaayyyyssssOOOOnnnneeee set to True and none of the toggle children selected. The result is undefined if the value of this resource is True and the application sets more than one ToggleButton at a time. XXXXmmmmNNNNrrrraaaaddddiiiiooooBBBBeeeehhhhaaaavvvviiiioooorrrr Specifies a Boolean value that when True, indicates that the RowColumn widget should enforce a RadioBox-type behavior on all of its children that are ToggleButtons or ToggleButtonGadgets. When the value of this resource is True, XXXXmmmmNNNNiiiinnnnddddiiiiccccaaaattttoooorrrrTTTTyyyyppppeeee defaults to XXXXmmmmOOOONNNNEEEE____OOOOFFFF____MMMMAAAANNNNYYYYfor ToggleButton and ToggleButtonGadget children. RadioBox behavior dictates that when one toggle is selected and the user selects another toggle, the first toggle is unselected automatically. The RowColumn usually does not enforce this behavior if the application, rather than the user, changes the state of a toggle. The RowColumn does enforce this behavior if a toggle child is selected with XXXXmmmmTTTToooogggggggglllleeeeBBBBuuuuttttttttoooonnnnSSSSeeeettttSSSSttttaaaatttteeee or XXXXmmmmTTTToooogggggggglllleeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeettttSSSSeeeettttSSSSttttaaaatttteeeewith a _n_o_t_i_f_y argument of True. When XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRaaaaddddiiiiooooBBBBooooxxxx is called, the default value of XXXXmmmmNNNNrrrraaaaddddiiiiooooBBBBeeeehhhhaaaavvvviiiioooorrrr is True. Otherwise, the default value is False. XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeeHHHHeeeeiiiigggghhhhtttt Requests a new height if necessary, when set to True. When this resource is set to False, the widget does not request a new height regardless of any changes to the widget or its children. XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeeWWWWiiiiddddtttthhhh Requests a new width if necessary, when set to True. When set to False, the widget does not request a new width regardless of any changes to the widget or its children. XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee Specifies the type of RowColumn widget to be created. It is a nonstandard resource that cannot Page 13 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) be changed after it is set. If an application uses any of the convenience routines, except XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRoooowwwwCCCCoooolllluuuummmmnnnn, this resource is automatically forced to the appropriate value by the convenience routine. If an application uses the Xt Intrinsics API to create its RowColumn widgets, it must specify this resource itself. The set of possible settings for this resource are +o XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA (default) +o XXXXmmmmMMMMEEEENNNNUUUU____BBBBAAAARRRR +o XXXXmmmmMMMMEEEENNNNUUUU____PPPPUUUULLLLLLLLDDDDOOOOWWWWNNNN +o XXXXmmmmMMMMEEEENNNNUUUU____PPPPOOOOPPPPUUUUPPPP +o XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN This resource cannot be changed after the RowColumn widget is created. Any changes attempted through XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessssare ignored. The value of this resource is used to determine the value of a number of other resources. The descriptions of RowColumn resources explain this when it is the case. The resource XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee, inherited from XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, is changed to XXXXmmmmNNNNOOOONNNNEEEE if XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN. XXXXmmmmNNNNssssppppaaaacccciiiinnnngggg Specifies the horizontal and vertical spacing between items contained within the RowColumn widget. The default value is 3 pixels for XXXXmmmmOOOOPPPPTTTTIIIIOOOONNNN____MMMMEEEENNNNUUUU and XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA and 0 (zero) for other RowColumn types. XXXXmmmmNNNNssssuuuubbbbMMMMeeeennnnuuuuIIIIdddd Specifies the widget ID for the Pulldown menu pane to be associated with an OptionMenu. This resource is useful only when XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN. The default value is NULL. XXXXmmmmNNNNtttteeeeaaaarrrrOOOOffffffffMMMMeeeennnnuuuuAAAAccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk Specifies the callback list that notifies the application when the tear-off menu pane is about to be activated. It precedes the tear-off's map callback. Use this resource when your application has shared menu panes and when the torn-off menu can have two Page 14 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) or more parents that can have opposing sensitivity states for the same menu item. This resource enables the application to track whether a menu item is sensitive or insensitive and to set the state to the original parent's menu item state when the torn-off menu is reposted. The application can use XXXXmmmmGGGGeeeettttPPPPoooosssstttteeeeddddFFFFrrrroooommmmWWWWiiiiddddggggeeeetttt to determine from which parent the menu was torn. The callback reason is XXXXmmmmCCCCRRRR____TTTTEEEEAAAARRRR____OOOOFFFFFFFF____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE. The default is NULL. XXXXmmmmNNNNtttteeeeaaaarrrrOOOOffffffffMMMMeeeennnnuuuuDDDDeeeeaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk Specifies the callback list that notifies the application when the tear-off menu pane is about to be deactivated. It follows the tear-off's unmap callback. Use this resource when your application has shared menu panes and when the torn-off menu can have two or more parents that can have opposing sensitivity states for the same menu item. This resource enables the application to track whether a menu item is sensitive or insensitive and to set the state to the original parent's menu item state when the torn-off menu is reposted. The application can use XXXXmmmmGGGGeeeettttPPPPoooosssstttteeeeddddFFFFrrrroooommmmWWWWiiiiddddggggeeeetttt to determine from which parent the menu was torn. The callback reason is XXXXmmmmCCCCRRRR____TTTTEEEEAAAARRRR____OOOOFFFFFFFF____DDDDEEEEAAAACCCCTTTTIIIIVVVVAAAATTTTEEEE. The default is NULL. XXXXmmmmNNNNtttteeeeaaaarrrrOOOOffffffffMMMMooooddddeeeellll Indicates whether tear-off functionality is enabled or disabled when XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmMMMMEEEENNNNUUUU____PPPPUUUULLLLLLLLDDDDOOOOWWWWNNNN or XXXXmmmmMMMMEEEENNNNUUUU____PPPPOOOOPPPPUUUUPPPP. The values are XXXXmmmmTTTTEEEEAAAARRRR____OOOOFFFFFFFF____EEEENNNNAAAABBBBLLLLEEEEDDDD or XXXXmmmmTTTTEEEEAAAARRRR____OOOOFFFFFFFF____DDDDIIIISSSSAAAABBBBLLLLEEEEDDDD (default value). This resource is invalid for type XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN; however, it does affect any pulldown submenus within an OptionMenu. The function XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeIIIInnnnssssttttaaaallllllllTTTTeeeeaaaarrrrOOOOffffffffMMMMooooddddeeeellllCCCCoooonnnnvvvveeeerrrrtttteeeerrrr installs a resource converter for this resource. _X_m_N_t_e_a_r_o_f_f_T_i_t_l_e Used by the TearOff shell to set the title for the window manager to display. XXXXmmmmNNNNuuuunnnnmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk Specifies a list of callbacks that is called after the window associated with the RowColumn widget has been unmapped. The callback reason is XXXXmmmmCCCCRRRR____UUUUNNNNMMMMAAAAPPPP. The default value is NULL. XXXXmmmmNNNNwwwwhhhhiiiicccchhhhBBBBuuuuttttttttoooonnnn Page 15 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) This resource is obsolete; it has been replaced by XXXXmmmmNNNNmmmmeeeennnnuuuuPPPPoooosssstttt and is present for compatibility with older releases of Motif. This resource cannot be 2. XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNpositionIndex XmCPositionIndex short XmLAST_POSITION CSG XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx Specifies the position of the widget in its parent's list of children (the value of the XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn resource). The value is an integer that is no less than 0 (zero) and no greater than the number of children in the list at the time the value is specified. A value of 0 (zero) means that the child is placed at the beginning of the list. The value can also be specified as XXXXmmmmLLLLAAAASSSSTTTT____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN (the default), which means that the child is placed at the end of the list. Any other value is ignored. XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns the position of the widget in its parent's child list at the time of the call to XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss. When a widget is inserted into its parent's child list, the positions of any existing children that are greater than or equal to the specified widget's XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx are increased by 1. The effect of a call to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss for XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxxis to remove the specified widget from its parent's child list, decrease by 1 the positions of any existing children that are greater than the specified widget's former position in the list, and then insert the specified widget into its parent's child list as described in the preceding sentence. SSSSiiiimmmmpppplllleeee MMMMeeeennnnuuuu CCCCrrrreeeeaaaattttiiiioooonnnn RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNbuttonAccelerators XmCButtonAccelerators StringTable NULL C XmNbuttonAcceleratorText XmCButtonAcceleratorText XmStringTable NULL C XmNbuttonCount XmCButtonCount int 0 C XmNbuttonMnemonicCharSets XmCButtonMnemonicCharSets XmStringCharSetTable NULL C XmNbuttonMnemonics XmCButtonMnemonics XmKeySymTable NULL C XmNbuttons XmCButtons XmStringTable NULL C XmNbuttonSet XmCButtonSet int -1 C XmNbuttonType XmCButtonType XmButtonTypeTable NULL C XmNoptionLabel XmCOptionLabel XmString NULL C XmNoptionMnemonic XmCOptionMnemonic KeySym NULL C XmNpostFromButton XmCPostFromButton int -1 C Page 16 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) XmNsimpleCallback XmCCallback XtCallbackProc NULL C XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnAAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssss This resource is for use with the simple menu creation routines. It specifies a list of accelerators for the buttons created. The list contains one element for each button, separator, and title created. XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnAAAAcccccccceeeelllleeeerrrraaaattttoooorrrrTTTTeeeexxxxtttt This resource is for use with the simple menu creation routines. It specifies a list of compound strings to display for the accelerators for the buttons created. The list contains one element for each button, separator, and title created. XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnCCCCoooouuuunnnntttt This resource is for use with the simple menu creation routines. It specifies the total number of menu buttons, separators, and titles to create. The value must not be negative. XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnMMMMnnnneeeemmmmoooonnnniiiiccccCCCChhhhaaaarrrrSSSSeeeettttssss This resource is for use with the simple menu creation routines. It specifies a list of character sets with which button mnemonics are to be displayed. The list contains one element for each button, separator, and title created. The default is determined dynamically depending on the locale of the widget. XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnMMMMnnnneeeemmmmoooonnnniiiiccccssss This resource is for use with the simple menu creation routines. It specifies a list of mnemonics for the buttons created. The list contains one element for each button, separator, and title created. XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnssss This resource is for use with the simple menu creation routines. It specifies a list of compound strings to use as labels for the buttons created. The list contains one element for each button, separator, and title created. XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnSSSSeeeetttt This resource is for use with the simple menu creation routines. It specifies which button of a RadioBox or OptionMenu Pulldown submenu is initially set. The value is an integer _n indicating the _nth ToggleButtonGadget specified Page 17 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) for a RadioBox or the _nth PushButtonGadget specified for an OptionMenu Pulldown submenu. The first button specified is number 0. The value must not be negative. XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnTTTTyyyyppppeeee This resource is for use with the simple menu creation routines. It specifies a list of button types associated with the buttons to be created. The list contains one element for each button, separator, and title created. If this resource is not specified, each button in a MenuBar is a CascadeButtonGadget, each button in a RadioBox or CheckBox is a ToggleButtonGadget, and each button in any other type of RowColumn widget is a PushButtonGadget. Each button type is of type XXXXmmmmBBBBuuuuttttttttoooonnnnTTTTyyyyppppeeee, an enumeration with the following possible values: XXXXmmmmCCCCAAAASSSSCCCCAAAADDDDEEEEBBBBUUUUTTTTTTTTOOOONNNN Specifies a CascadeButtonGadget for a MenuBar, Popup menu pane, or Pulldown menu pane. XXXXmmmmCCCCHHHHEEEECCCCKKKKBBBBUUUUTTTTTTTTOOOONNNN Specifies a ToggleButtonGadget for a CheckBox, Popup menu pane, or Pulldown menu pane. XXXXmmmmDDDDOOOOUUUUBBBBLLLLEEEE____SSSSEEEEPPPPAAAARRRRAAAATTTTOOOORRRR Specifies a SeparatorGadget for a Popup menu pane, Pulldown menu pane, or OptionMenu Pulldown submenu. The separator type is XXXXmmmmDDDDOOOOUUUUBBBBLLLLEEEE____LLLLIIIINNNNEEEE. XXXXmmmmPPPPUUUUSSSSHHHHBBBBUUUUTTTTTTTTOOOONNNN Specifies a PushButtonGadget for a Popup menu pane, Pulldown menu pane, or OptionMenu Pulldown submenu. XXXXmmmmRRRRAAAADDDDIIIIOOOOBBBBUUUUTTTTTTTTOOOONNNN Specifies a ToggleButtonGadget for a RadioBox, Popup menu pane, or Pulldown menu pane. XXXXmmmmSSSSEEEEPPPPAAAARRRRAAAATTTTOOOORRRR Specifies a SeparatorGadget for a Popup menu pane, Pulldown menu pane, or OptionMenu Pulldown submenu. XXXXmmmmTTTTIIIITTTTLLLLEEEE Specifies a LabelGadget used as a title for a Popup menu pane or Pulldown menu Page 18 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) pane. XXXXmmmmNNNNooooppppttttiiiioooonnnnLLLLaaaabbbbeeeellll This resource is for use with the simple menu creation routines. It specifies a compound string for the label string to be used on the left side of an OptionMenu. XXXXmmmmNNNNooooppppttttiiiioooonnnnMMMMnnnneeeemmmmoooonnnniiiicccc This resource is for use with the simple menu creation routines. It specifies a keysym for a key that, when pressed by the user along with the MMMMAAAAlllltttt modifier, posts the associated Pulldown menu pane for an OptionMenu. XXXXmmmmNNNNppppoooossssttttFFFFrrrroooommmmBBBBuuuuttttttttoooonnnn This resource is for use with the simple menu creation routines. For a Pulldown menu pane, it specifies the button in the parent to which the submenu is attached. The menu is then posted from this button. The value is an integer _n indicating the _nth CascadeButton or CascadeButtonGadget specified for the parent of the Pulldown menu pane. The first button specified is number 0. The value must not be negative. XXXXmmmmNNNNssssiiiimmmmpppplllleeeeCCCCaaaallllllllbbbbaaaacccckkkk This resource is for use with the simple menu creation routines. It specifies a callback procedure to be called when a button is activated or when its value changes. This callback function is added to each button after creation. For a CascadeButtonGadget or a PushButtonGadget, the callback is added as the button's XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk, and it is called when the button is activated. For a ToggleButtonGadget, the callback is added as the button's XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk, and it is called when the button's value changes. The button number is passed in the _c_l_i_e_n_t__d_a_t_a field. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss RowColumn inherits behavior and resources from the superclasses described in the following tables. For a complete description of each resource, refer to the reference page for that superclass. XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG Page 19 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNforeground XmCForeground Pixel dynamic CSG XmNhelpCallback XmCCallback XtCallbackList NULL C XmNhighlightColor XmCHighlightColor Pixel dynamic CSG XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG XmNinitialFocus XmCInitialFocus Widget NULL CSG XmNlayoutDirection XmCLayoutDirection XmDirection dynamic CG XmNnavigationType XmCNavigationType XmNavigationType dynamic CSG XmNpopupHandlerCallback XmCCallback XtCallbackList NULL C XmNshadowThickness XmCShadowThickness Dimension dynamic CSG XmNstringDirection XmCStringDirection XmStringDirection dynamic CG XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG XmNtraversalOn XmCTraversalOn Boolean dynamic CSG XmNunitType XmCUnitType unsigned char dynamic CSG XmNuserData XmCUserData XtPointer NULL CSG CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNchildren XmCReadOnly WidgetList NULL G XmNinsertPosition XmCInsertPosition XtOrderProc default procedure CSG XmNnumChildren XmCReadOnly Cardinal 0 G CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG XmNancestorSensitive XmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations dynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed to each callback: typedef struct { int _r_e_a_s_o_n; Page 20 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) XEvent * _e_v_e_n_t; Widget _w_i_d_g_e_t; char * _d_a_t_a; char * _c_a_l_l_b_a_c_k_s_t_r_u_c_t; } XmRowColumnCallbackStruct; _r_e_a_s_o_n Indicates why the callback was invoked _e_v_e_n_t Points to the _X_E_v_e_n_t that triggered the callback The following fields apply only when the callback reason is XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE; for all other callback reasons, these fields are set to NULL. The XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE callback reason is generated only when the application has supplied an entry callback, which overrides any activation callbacks registered with the individual RowColumn items. _w_i_d_g_e_t Is set to the widget ID of the RowColumn item that has been activated _d_a_t_a Contains the client-data value supplied by the application when the RowColumn item's activation callback was registered _c_a_l_l_b_a_c_k_s_t_r_u_c_t Points to the callback structure generated by the RowColumn item's activation callback TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn translations depend on the value of the XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee resource. If XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA, XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn inherits translations from XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr. If XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmMMMMEEEENNNNUUUU____OOOOPPPPTTTTIIIIOOOONNNN, XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn inherits traversal, <<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>>, and <<<<oooossssffffCCCCaaaannnncccceeeellll>>>>translations from XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrrand has the following additional translations. The following key names are listed in the X standard key event translation table syntax. This format is the one used by Motif to specify the widget actions corresponding to a given key. A brief overview of the format is provided under VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3). For a complete description of the format, please refer to the X Toolkit Instrinsics Documentation. <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>: MenuGadgetDrag() cccc<<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>: Page 21 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) MenuGadgetTraverseCurrent() cccc<<<<BBBBttttnnnn1111UUUUpppp>>>>: MenuGadgetTraverseCurrentUp() ~~~~cccc<<<<BBBBttttnnnnDDDDoooowwwwnnnn>>>>: MenuBtnDown() ~~~~cccc<<<<BBBBttttnnnnUUUUpppp>>>>: MenuBtnUp() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>: MenuHelp() The translations for XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn if XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is set to XXXXmmmmMMMMEEEENNNNUUUU____BBBBAAAARRRRXXXXmmmmMMMMEEEENNNNUUUU____PPPPUUUULLLLLLLLDDDDOOOOWWWWNNNN, or XXXXmmmmMMMMEEEENNNNUUUU____PPPPOOOOPPPPUUUUPPPPare described in the following list. In a Popup menu system, <<<<BBBBttttnnnn3333>>>> also performs the <<<<BBBBttttnnnn1111>>>>actions. ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>: MenuHelp() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>: MenuGadgetTraverseLeft() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>: MenuGadgetTraverseRight() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>: MenuGadgetTraverseUp() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>: MenuGadgetTraverseDown() AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss The XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn action routines are Help(): Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any exist. If there are no help callbacks for this widget, this action calls the help callbacks for the nearest ancestor that has them. ManagerGadgetSelect(): When a gadget child of the menu has the focus, invokes the gadget child's behavior associated with <<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>. This generally has the effect of unposting the menu hierarchy and arming and activating the gadget, except that, for a CascadeButtonGadget with a submenu, it posts the submenu. MenuBtnDown(): Page 22 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) When a gadget child of the menu has focus, invokes the gadget child's behavior associated with <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>. This generally has the effect of unposting any menus posted by the parent menu, enabling mouse traversal in the menu, and arming the gadget. For a CascadeButtonGadget with a submenu, it also posts the associated submenu. MenuBtnUp(): When a gadget child of the menu has focus, invokes the gadget child's behavior associated with <<<<BBBBttttnnnn1111UUUUpppp>>>>. This generally has the effect of unposting the menu hierarchy and activating the gadget, except that for a CascadeButtonGadget with a submenu, it posts the submenu and enables keyboard traversal in the menu. MenuGadgetEscape(): In a top-level Pulldown MenuPane from a MenuBar, unposts the menu, disarms the MenuBar CascadeButton and the MenuBar, and, when the shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, restores keyboard focus to the widget that had the focus before the MenuBar was entered. In other Pulldown MenuPanes, unposts the menu. In a Popup MenuPane, unposts the menu and, when the shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, restores keyboard focus to the widget from which the menu was posted. In a TearOff MenuPane that has no submenus posted, dismisses the menu; otherwise, if one or more submenus are posted, unposts the last menu pane. MenuGadgetTraverseDown(): If the current menu item has a submenu and is in a MenuBar, then this action posts the submenu, disarms the current menu item, and arms the submenu's first traversable menu item. If the current menu item is in a MenuPane, then this action disarms the current menu item and arms the item below it. This action wraps within the MenuPane. The direction of the wrapping depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource. MenuGadgetTraverseLeft(): When the current menu item is in a MenuBar, this action disarms the current item and arms the MenuBar item to the left. This action wraps within the MenuBar. Page 23 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) In MenuPanes, if the current menu item is not at the left edge of a MenuPane, this action disarms the current item and arms the item to its left. If the current menu item is at the left edge of a submenu attached to a MenuBar item, then this action unposts the submenu and traverses to the MenuBar item to the left, wrapping if necessary. If that MenuBar item has a submenu, it posts the submenu and arms the first traversable item in the submenu. If the current menu item is at the left edge of a submenu not directly attached to a MenuBar item, then this action unposts the current submenu only. In Popup or Torn-off MenuPanes, when the current menu item is at the left edge, this action wraps within the MenuPane. If the current menu item is at the left edge of the MenuPane and not in the top row, this action wraps to the rightmost menu item in the row above. If the current menu item is in the upper, leftmost corner, this action wraps to the tear-off control, if present, or else it wraps to the bottom, rightmost menu item in the MenuPane. The preceding description applies when the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn horizontal direction is XXXXmmmmLLLLEEEEFFFFTTTT____TTTTOOOO____RRRRIIIIGGGGHHHHTTTT. If the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn horizontal direction is XXXXmmmmRRRRIIIIGGGGHHHHTTTT____TTTTOOOO____LLLLEEEEFFFFTTTT, then the following applies. If the current menu item is in a MenuBar, then this action disarms the current item and arms the MenuBar item to the left. This action wraps within the MenuBar. In MenuPanes, if the current menu item is a CascadeButton, then this action posts its associated submenu. If the current menu item is not a CascadeButton and is not at the left edge of a MenuPane, this action disarms the current item and arms the item to its left, wrapping if necessary. If the current menu item is not a CascadeButton and is at the left edge of a submenu that is a descendent of a MenuBar, then this action unposts all submenus and traverses to the MenuBar item to the left. If that MenuBar item has a submenu, it posts the submenu and arms the submenu's first traversable item. In Popup or Torn-off menus, if the current menu item is not a CascadeButton and is at the left Page 24 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) edge of a row (except the bottom row), this action wraps to the rightmost menu item in the row below. If the current menu item is not a CascadeButton and is in the bottom, leftmost corner of a Popup or Pulldown MenuPane, this action wraps to the tear-off control, if present, or else it wraps to the top, rightmost menu item of the MenuPane. MenuGadgetTraverseRight(): If the current menu item is in a MenuBar, then this action disarms the current item and arms the MenuBar item to the right. This action wraps within the MenuBar. In MenuPanes, if the current menu item is a CascadeButton, then this action posts its associated submenu. If the current menu item is not a CascadeButton and is not at the right edge of a MenuPane, this action disarms the current item and arms the item to its right, wrapping if necessary. If the current menu item is not a CascadeButton and is at the right edge of a submenu that is a descendent of a MenuBar, then this action unposts all submenus and traverses to the MenuBar item to the right. If that MenuBar item has a submenu, it posts the submenu and arms the submenu's first traversable item. In Popup or Torn-off menus, if the current menu item is not a CascadeButton and is at the right edge of a row (except the bottom row), this action wraps to the leftmost menu item in the row below. If the current menu item is not a CascadeButton and is in the bottom, rightmost corner of a Popup or Pulldown MenuPane, this action wraps to the tear-off control, if present, or else it wraps to the top, leftmost menu item of the MenuPane. The preceding description applies when the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn horizontal direction is XXXXmmmmLLLLEEEEFFFFTTTT____TTTTOOOO____RRRRIIIIGGGGHHHHTTTT. If the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn horizontal direction is XXXXmmmmRRRRIIIIGGGGHHHHTTTT____TTTTOOOO____LLLLEEEEFFFFTTTT, then the following applies. When the current menu item is in a MenuBar, this action disarms the current item and arms the MenuBar item to the left. This action wraps within the MenuBar. In MenuPanes, if the current menu item is not at the right edge of a MenuPane, this action disarms the current item and arms the item to its right. If the current menu item is at the right edge of a submenu attached to a MenuBar item, then this Page 25 (printed 10/3/02) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) action unposts the submenu and traverses to the MenuBar item to the right, wrapping if necessary. If that MenuBar item has a submenu, it posts the submenu and arms the first traversable item in the submenu. If the current menu item is at the right edge of a submenu not directly attached to a MenuBar item, then this action unposts the current submenu only. In Popup or Torn-off MenuPanes, when the current menu item is at the right edge, this action wraps within the MenuPane. If the current menu item is at the right edge of the MenuPane and not in the top row, this action wraps to the leftmost menu item in the row above. If the current menu item is in the upper, rightmost corner, this action wraps to the tear-off control, if present, or else it wraps to the bottom, leftmost menu item in the MenuPane. MenuGadgetTraverseUp(): When the current menu item is in a MenuPane, then this action disarms the current menu item and arms the item above it. This action wraps within the MenuPane. The direction of the wrapping depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource. RRRReeeellllaaaatttteeeedddd BBBBeeeehhhhaaaavvvviiiioooorrrr The following menu functions are available: <<<<oooossssffffMMMMeeeennnnuuuuBBBBaaaarrrr>>>>: In any non-popup descendant of a MenuBar's parent, excluding the MenuBar itself, this action enables keyboard traversal and moves keyboard focus to the first item in the MenuBar. In the MenuBar or any menu cascaded from it, this action unposts the menu hierarchy and, when the shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, restores focus to the widget that had the focus when the menu system was entered. <<<<oooossssffffMMMMeeeennnnuuuu>>>>: Pops up the menu associated with the control that has the keyboard focus. Enables keyboard traversal in the menu. In the Popup menu system or any menu cascaded from it, this action unposts the menu hierarchy and, when the shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, restores focus to the widget that had the focus when the menu system was entered. VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss PPPPaaaaggggeeee 22226666 ((((pppprrrriiiinnnntttteeeedddd 11110000////3333////00002222)))) XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))) The bindings for virtual keys are vendor specific. For information about bindings for virtual buttons and keys, see VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3). RRRREEEELLLLAAAATTTTEEEEDDDD CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeMMMMeeeennnnuuuuBBBBaaaarrrr(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeOOOOppppttttiiiioooonnnnMMMMeeeennnnuuuu(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRaaaaddddiiiiooooBBBBooooxxxx(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeRRRRoooowwwwCCCCoooolllluuuummmmnnnn(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeOOOOppppttttiiiioooonnnnMMMMeeeennnnuuuu(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeWWWWoooorrrrkkkkAAAArrrreeeeaaaa(3), XXXXmmmmGGGGeeeettttMMMMeeeennnnuuuuCCCCuuuurrrrssssoooorrrr(3), XXXXmmmmGGGGeeeettttPPPPoooosssstttteeeeddddFFFFrrrroooommmmWWWWiiiiddddggggeeeetttt(3), XXXXmmmmGGGGeeeettttTTTTeeeeaaaarrrrOOOOffffffffCCCCoooonnnnttttrrrroooollll, XXXXmmmmLLLLaaaabbbbeeeellll(3), XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3), XXXXmmmmMMMMeeeennnnuuuuPPPPoooossssiiiittttiiiioooonnnn(3), XXXXmmmmOOOOppppttttiiiioooonnnnBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt(3), XXXXmmmmOOOOppppttttiiiioooonnnnLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt(3), XXXXmmmmRRRReeeeppppTTTTyyyyppppeeeeIIIInnnnssssttttaaaallllllllTTTTeeeeaaaarrrrOOOOffffffffMMMMooooddddeeeellllCCCCoooonnnnvvvveeeerrrrtttteeeerrrr, XXXXmmmmSSSSeeeettttMMMMeeeennnnuuuuCCCCuuuurrrrssssoooorrrr(3), XXXXmmmmUUUUppppddddaaaatttteeeeDDDDiiiissssppppllllaaaayyyy(3), XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeCCCChhhheeeecccckkkkBBBBooooxxxx(3), XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuuBBBBaaaarrrr(3), XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeOOOOppppttttiiiioooonnnnMMMMeeeennnnuuuu(3), XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu(3), XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu(3), and XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeeRRRRaaaaddddiiiiooooBBBBooooxxxx(3). Page 27 (printed 10/3/02) 
